请求
curl --location 'https://openapi.gs-robot.com/openapi/v3/schedules/plans/simple/update' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{token}}' \
--data '{
"clientTime": 1760328396004,
"clientTimeZone": "Asia/Shanghai",
"dayOfMonth": 29,
"loopCount": 1,
"mapResourceList": [
{
"floorIndex": 1,
"floorName": "1F",
"mapId": "140bbb83-fe48-4282-be25-c48252b9c660",
"mapName": "Factory 1F",
"mapResourceAreaId": "1",
"mapResourceId": "327594d9-df72-4950-94b2-64e6d02abdfb",
"mapResourceName": "area1",
"mapResourceType": "region",
"robotMapUuid": "140bbb83-fe48-4282-be25-c48252b9c660"
}
],
"month": 8,
"operationType": 2,
"planExecuteType": 2,
"planRepeatType": 0,
"planRepeatWeekly": [
1,
3,
5
],
"planStartDate": "2026-08-29",
"planStartTime": "10:30",
"planStopDate": "2099-12-31",
"planStopTime": "",
"planUuid": "plan-1",
"robotSn": "TEST00-0000-000-B088",
"siteId": "site-1",
"siteMode": 0,
"taskAdvanceConfig": {
"autoPlanning": true,
"coverageMode": "standard",
"tempTaskPriority": false
},
"taskName": "Simple schedule",
"workMode": {
"mode": "wash",
"strength": "middle",
"subType": "wash",
"type": 0
},
"year": 2026
}'
版本限制:本接口仅支持 AIO1.6 及以上软件版本。
注意事项
workMode.mode必须使用机器人可用的工作模式机器码,仅允许小写字母、数字和下划线。planStartDate、planStopDate和时间字段会按clientTimeZone校验;开始日期不能早于当前日期,结束日期不能早于开始日期,结束时间必须晚于开始时间。- 地图资源、WorkMode 和日期时间校验在查询原计划及调用下游前执行。对应的业务错误码包括
230004(资源不存在)、230005(WorkMode 不匹配)、230011(日期无效)、230012(时间无效)和230013(开始日期已过)。 - 除成功码
0外,失败响应使用六位code。
输出
{
"code": 0,
"data": {},
"msg": "success"
}